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ACCESS MODE, 
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2-2 HARDWARE TYPE expanded to in- 
clude Gassette and Binary 
Card files. 

-3: Hex search added. 
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CINPUT and OUTPUT). 

3-2: CASS, BINARY, and LIST added. 
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panded to include CAS,BIN, and 
LST. 

3-3: Note revised. 
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4-2: Error messages 15-17 added, 
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Table 2.1. 

Added Multi-pack disk file Hardware ty 
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GENERAL DESCRIPTION 


OHPALL is a general wedia conversion ecrogram used to transfer 
files from one hardware sedium to another. It aiso can tist 
files from any mediua with a bytes digits or combined form. 
Along with these abilities it can start or stop reading files at 
2 specified record. Specificaticns may be passed to OMPALL fron 
either a console keyboard or a card readere with the defauit node 
a8 console keytoara (SPO) input. Various program suitches (Csee 
SWITCH SETTINGS) can atso be used to controt the type of 
execution that the user desires. , 


RELATED DOCURENTATICA 


B1i800/B81700 Systens Softuare Cpoeraticnat Guide #1068733 
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GPERATING INSTRUCTIONS 
CONSCLE KEYSCAFO JREUT 


OMPALL is normally executec from the console keyboard. It is 
executed with an #CP execute string CEX OMPALL) and responds with 
the following: 


OMPALL 
DHPALL 


<job-nusberoENnTER SPECS 
<job-nusber> ACCEPT 


Wit 


The operator repties ta the accept message by entering 32 
<job-number >Aax <specification string> where <specification 
string> contains the specificaticrs needed to performs the’ ODOHPALL 
operations and <job-nugber> refers to the untque job numter 
assigned by the KCP. A specification string is defined as the 
sequence of vaitd (MPALL ccesandss and their required parameters» 
that praduces the type of data transfer the user desires. 


Enteties are opticnat when ONPALL can find the required 
information from another source €@.gee disk file header of a disk 
file) or when the input itself indicates the type of processing 
CGeguor CARD of CRO presumes an unbiccked fite). Tifegat 
specifications are reported as errors and an appropriate error 
message is disptayeo on the SPO. 


Examples of Console Keybcard Input 


A response of 

<job-nusber>AxX LIST PACKA/SPAYROLL/S A SKIP 50 
causes 282 disk fite identified as *PAYROLL™ and tocated on the 
yemovable disk “PACKA™ tea be printed beginning with the 
fifty-first record. 
A response of 

<jobr-number>AXx COPY CRCOSK CARD SOURCE 8&0 2 


causes a card file with the file-identifier "CARD" to be written 
to a disk files 80-character records» biocked Ze with the 
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fileridentifier “SCURCE*. 


A response of 


<job-nunber>aAx COPY PROGRAM/8 CCC/PROGRAN/S 
causes a disk file “"PROGRAN/S8” Located on a system disk to be 


copied to the ¢rernovable cisk “CCC with the identifier 
“PROGRAN/B* « : 


AHITTCH SETTINGS 


Modifications of the switch settings change the zero value 
Cdefauit) of the switch ang aiter the way DMPALL executes. These 


Switches can be persanentiy set (Cmodified)> changed during 
program execution or specified at execution ttme before the 
specification string(s) are accepted. (See Software Operational 
Guide). , 


The default values of ONPALL®s program switches ares 


SWITCH VALUE RESULT 

Specifications accepted onty from the SPO 
Continue process untit the end 

Continue with next specification 

interpret card decks Chardware permitting) 
Stop if an error is encountered on input fites 


OW ON es 
OOoao 


These switches can be reset with the following vaiues to produce 
the resuits described: 


SWITCH VALUE RESULT 


0 1 Specificattons accepted cniy from CARDS 


i 1 - Yerminate processing of current specifications 
proceed to next specificaticn 

7 1 Stop OMPALL after cospletion cf the next 
executed specification 

8 1 tio interpretation of card decks desired 

9 1 Kgnore input fille errors 
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CARO INPUT 


When executed through a card reader C€?EX ODMPALL) with SWO=1e 
DMPALL expects ait specifications tc be entered from the card 
feader. . 


The ONPALL execute controt deck has the following format: 


2 EX OMPALL SHO=13 - 
2 FI SPEC NANE <SPEC_FILE_IDENTIFIER>s COptional Card} 
2 DATA <SPEC_LFILE_ICERTIFIER> 

(Specification cards) 
? END 


A semicoton will tersinate the specification string» after which 
comments may be entered. There may be tore than one card in &@ 
specification card file. 


AGL specificatian entries are free form in up te 96 cotunns of a 
cards anc may be separated by either a space or a commae or a 
combination thereof. The card file contairing the specifications 
is Loaded to disk» and aach specification is executed in turn. 


Examoie of Card Input 


? EX DMNPALL SHO=1s 

2? OATA SPEC . 
COPY CROOSK XXX 72 L DOSKFIL 80 4 
LIST CSKFIL A 

2 OATA XXX 
CCar<¢ data deck) 

2 END 


The specifications wilt cause the card file "XXX" to be Loaded to 
disks then listed in alpha fcernat. 
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PRIRT SPECIFICATIONS 


t 


The specification string fcr printing a file is shoxrn in the 
syntax diagram table 3.1 anc expdained in the pages that follow. 
A valid DHPALL conrand is cevelorped from following the saain tine 
of syntax from tits beginning to its termination point (#@). khere 
optional entries are concerneds the direction of flow proceeds 
down on the teftehand Cine and up an the right.j. Uniess atherwise 
noted» optional ertries are expected by the program in the order 
(top to bottam) in which they are presented. A @ine that pay 
only be crossed cnce is shcun by “/1N°. 


Requirad entries occur on the gain Line of developments optional 
ones below that tine. Required keyworos appear in upper-case 
hetters;> vVariabies in tower-case Letters. Undertined portions 
of required keywords are acceptable abbreviations for the 
keywords. Abbreviations of variabies that occur in table 3.1 ere 
as follous: ; 


Var iabie Abbreviation 
identifier id 
record rec 
mnunber nus 
position posn 
fength feng 
argunent arg 
operator op 


The LIST» LST» LISTL of LSTL entry indicates a single-spaced 
€isting wit be printeds LIST2 of LST2 specifies double-spaced. 


The <file-id> entry sust taeediately follow the LIST entry and is 
required for aii files. The forrat of the <file-id> entry is the 
same as used in ¥CF control instructions: from one to three 
identifiers separated by slashes. A f3@ecidentifier that is 
entirely numeric or which contains special characters must be 
surrounded by quotes. CSee B18O00/B8iL7CO Software Onerationat 
Guide for sore detaiis.) 
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ew LIsT SOMOS AMHBAADBDOOSAHKBDEREAE <fiierid> Seana mama ae a > > 


few LISTL “=>! 


| — mann - t ms 


i-- LIST2 -=>8 


>> SO GD OF 6 AD AE OE DO A SE DD A OS EE SOE RS Oe eR eR ee 


J fc ec ecuwweav coe we ons sna mam naw es a Senna nasa aemame § 


§-/1\-° <inputerecewleng> KAKI OMeBawEonoranumoaowaam > § 
f t-~ <biccking-factor> -"--->1 
§ | 
i-/irv\-- TAG? <tag-fite~id> SOM DKS OH Bem Ree ee we Y § 
f-/iN-~ cinput-file-access“made> ~s--s sees cree seen ennn=>] 
t-/1\-- <output-format> Ae Bese CWE Ke Wemam ees > § 
t<fit\-- chardware-tyre> an an <n oy Ses enema BED Bawammam > § 
E“/1N== SKIP <integer> w-o-e sen nn nnn nnn nen en nnn nen nnn - >] 
i | ¢ 
f-/1\-7- INCLULE <integqer> Seaweawnawmeewascoaeenemanaanawa > § 


i-/1\-~ YARIA@LE re en ee | 


i t- VARY e-<->) | 
i ‘ i 
, | | , 
bes INge? SEARTH ~- <starteposn> ---7 <searchrarg> 2=<273--->3 
8 <a i 

f-- SELECT -- <start-posn> ---- <searcharg> ---7-~=>{ 

t ——— t te § 2 

{ { <ee ce mw aoveawmoawecee | t i 

im" EXCLUCE=>% f-~ <nugs-torreturn> <->f  { 
t 2 > a 3 
fo KEY<-= <start=pesn> sean ueemeananaam ce key-op>-{ i 
fe-ckeyrtleng>->! | i 
t 

t 

‘ 

! 


§< wr wmwmee me an a 9 SAAB PSWSSSOHaeasn BDawnenean eee ee ee) § 
{ ; 
{-- <search-arg> 20D 10 ON 8 ER OD NT ED ey OD OD Oe oe eo oe ee ee oe ne ee en we en oe sos > 


f-- <nua~tc-return> ~->28 


=) 


Tabie 3.1 Print Specification String 
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The first numeric entry fetlouing the <file-id> must be the 
<inputerecceleng> in bytes Cmaximum Lengths 4-C00 bytes for ASCII 
converston or TAG: options and 6000 bytes for ail other iists). 
If omitted» an <inputerec“leng> of 80 and a <blocking-factor> of 
one is assumed for aii files except disk and tabeted tape files 
which use the <inputerectieng> and <blocking~factor> of the file 
when created. The second numeric entry fcliloning the <file-id> 
must te the <biock ing~factor>. If onitted and an 
<inputcrec@eng> entry is present» then an unblocked file is 
-assumede . 


The TAG: <tag-file-itd> entry may be used to specify the use of a 
tag file for indexirg into the input file. The tag file must be 
created with the COBOL or RPG naming conventions (see the CQGBOL 
or RPG reference manuaisd.s. 


The <input-file-access~made> entry may be cne of the foiloning 
Cineluding quotation marks}: 


le ASCII filess "ASCII 

2 BCL files? *ACL@ 

3e BENARY Files: “"BINARY* 

40 EBCDIC files: "PEBCDIC"® CIF this entry is omitteds "EBCOIC* 
¥#s assumed as the default.) 


If the input fite is a tabefed taper the access mode witl be that 
with which the file was created. 


The <output-format> entry eay be specified as: 


le Alphanumeric: A or ALFA. | 

2e Numerics Ne NUM» He or HEX. - 
CIf this entry is orsittedes ailphanuseric ts assumed as the 
defauit) 
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The <hardware-type> entry say be one of the following: 


le Card files: CRD or CARD 

2e 96~7col. Care filles: C96 or CARD96 
3o Magnetic Tape files: MTP or TAPE 
&4e Paper Tape fites: FPT or PAPER 


Se Disk files: CSK of CISK CAssuned if <hardwuaretype> onitted) 


60 ("Track Tape files: NT? or TAPE? 
Te 9-Track Tape ftites: T9 or TAPES 
Be Cassette Tape fides: CAS or CASS 
Go Binary Card files GIN or BINARY 
10-< Multi-pack Cisk files: MPF or HULTI 


The SKIP <integer> entry say be entered to begin printing after a 
spectfied number of records as denoted by the <integer>. 


The INCLUDE Cor TACL) <integer> entry may be used ta specify how 
gany records of the input ftie shouid be read. 


The ¥VARIABLE or VARY entry say be used to specify tape or disk 
fifes having variabiertength records. 


Selective printing of records can be accomplished by the 
foilouing options: 


OPTION EFFECT 

SEARCH Starts printing at the first occurrence 
SELECT Prints enty records that are equat 
EXCLUDE Prints onéy records that are not equai 
KEY Keytoperator condition 


NOTES Qnly ane option per specification atloued. 
These options are further cescribed by the following parameters: 


<start"posn> . <start-positon> denctes the starting position 
of the field where the first position in the 
record is retative cosition one. This numeric 
entry witit specify the byte (for alpha or 
hex)ds the digit (for 4-bit)» or the bit in 
which the field begins. 
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<key~teng> <keyrtength> is used enly with KEY option to 


specify the length of tke field to be tested. 
The maximum tength is 20 (bitse digits» or 
bytes). If this option is omitteds then the 
cefaudt wilt be equat to the length of the 
<search-argument> up to 20 Cbitss digitss or 
bytes de : 


<kay“op> <keyroperator> is used onty with KEY option to 
dencte the tyre of comparison to be perforsed 
by the KEY optton and aay be ons of the 
foticuing: 


Operator Neaning 
GTR or > Greater 
GE8 or >= Greater than or equat 
EG@iL or = Equai 
LEG or. <= Less than or equal 
Lss or < Less than 
REG Not equal 
<searchrarg> <search-argument> presents the data against 
‘which the specified field in the record wilt! 
be compared. - The type of field ts indicated 
by the field-type speci fier o f the 


<search-argument>s 


FIELC TYPE POSITION 


SPECIFIER TYPE DATA TYPE 

= or blank byte aiphanumeric 
a byte hexadecimat 
a(&) digit hexadecimal 
a1) bit binary 


The ending field-tyce specifier shauld be the 
same as the heginning specifier» except for 
digit and bit where "3" is sufficient. 


<num-to-r eturn> <nunber-tor-return> is ar integer used to- stop 
the seiective process after the number of 
records that the option specified has been 
reached. The SEARCH cption does not have this 
capabitity. Care should be taken when using 
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hoth the INCLUDE and <number-torreturn> 
options tcgethere as the List widd: terminate 
when either of the two options is satisfied. 


The heading for the output Listing contains the file identifiers 
record tlengthe biocking factors current date» and time. in 
additicne a printout of a disk file willl have the value of the 
end~of-file pointer in the heading. A running record count which 
indicates the record nusber of the input file is printed tn the 
fleftrhand margine 
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REPRODUCTION SPECIFICATIONS 


The reproduction string consists of the specifications shown in 
table 4.1 and expiained tir the pages that follow. A valid DMPALL 
coamand is developed from folioxing the main Line of syntax fron 
its beginning to its ter#ination point €#). Where optional 
entries are concerned» the cirection of fleu proceeds down on the 
@eft Line and up on the right. Fhe conventions and abtreviations 
used in this table are the same as those used in table 3.15 Print 
Specification String. 


PERF ORMe PF He» or COPY inforres OMPALL that media conversion is 
‘desired. lia | 


The <routine-type> entry may be either in honghand or shorthand 
fare The fonghand fora iutitizes the names of two of the 
foiflowing media: 


le Card files: CARD 

2e 86"col. Cards CARD96 

32 HWagnetic Tape fites: TAPE 

&. Paper Tape files: PAPER 

Se Disk files: OSK or CISK CAssumed if <rautine-type> onitted) 
6- "Track Tape files: TAPE? 
Te 97Track Tape fties: TAPE? 

8 Cassette Tape files: CASS 

9. Binary Carc ftbless BINARY 

10. Printer output fitess LIST 

fle Multi-pack Cisk files: HULTI 
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2) we acer PERFORM tO OF ER OP ORD ED OP G2 Rh ON a en <input~file-id>-->> 
f-- COPY cero in <rcutine-tyce> -->1 


PPS SOM Me He RHE Se COST HHT Ee CH HME ODDO O MSE MUENDoOUBeME NCAT OMe wemD EHO HH 
be re ce cet ent e cae ee a8 Se ee Bae RENTER MMOD ABs namom = | 
f-/1NeT" <inputereceLaeng> ssc ec sete cesses cca ase econ anaase~> | 
t i-- <blocking-factor> <--->] 
| a 
PSC INS@ VARTACLE, Se eee 2 ese ees Ses es eee seers Se See eres 
i ~- VARY seeerol 4 
t 
S-7iNe= TAGS <tag=fiterids “99s s Sesser es eee S sees eee== 24 
-/1Ne" <input~file-access=foder eects we eens wamamamamacaaa > | 
E“7 iN" <cutpet~tite=id>> s 998s 9S 594 6S S553 e ese ene 2 see = * 5 | 
G/N" <output-rrecleng> sce teres e wna cewewr enema mmnwmn> 
t f-- <biocking- factor> «--7r77-> 
i oO | i 
i Cette ee eee eel ' 
| t-- <Glocks-"perareg> comer eee rece re mew se seen anacna=> f 
t t<~- <number-of-areas> «~--~--~> {4 
f-/EN-- <cutput+fileraccess~sade> sees eer erence acammmomn> § 
E=JING= VARTACLE Se S33 S 9 S888 SSS SSeS eee SSS sess eee n> I 
| fem VARY oreo 33 
i i 
=f 1\""" SHIP <tnteqer> -S29 435869 $4 686465 se5S sSesees—4=):1 
B-/iNemm" INCLUCE <tinteger> seer t ese esea es cesses essa asaeen > | 
Q tia ta ‘ 
a i 
f-f/1\er* SEARCH *" <start=posn> ~7-- <searchrarg> c7r~---> 5 

1 co0 t 
f@- SELECT -—- <startrpoesn> <"-- <searchr-arg> s7---=">§ 
( o9< 3 a | 


i t § Cece me wwmoeaaawam as a 
fi-- EXCLUDE <i f-- <num*torreturn> ->§ 
i aa 73 Th 


t--<key~eng>->1 i 


{< ee cer ewanea BD CRE U8 08 1 ED OS i UH ON a a OR EP 2 On tae ane aD eS am aD a8 aD at a Aw aw ae ee me 


{-<- <s$e archrar g> 8 2 ES OD ED OE EN Oh SD AD EP OH AD Oh ED OD ON Oe OE HD ee ee oe om a a ee oe 


f-- <num"tcereturn> ">i 


Tabie 4.1 Reproduction Specification String 
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The shorthand form concatenates tuo of the following media abbre- 


viations: 


Note: ae 
be 
Exampte: 


2h a Be HD GR GD A GD SE GE GS DED EE a ER OD & OE AA EH OF OB CP EE GS OD 00 GE 68 OO oe es ee ae ee 


8 KEOIUM a ABBREVIATION { 
§ CARD : : “CRD U 
1 oe-ccu cake||=COUC(‘iHSOSO™”™*~*~* 
{ PARER TAPE i PPT § 
t MAGNETIC TAPE KTP t 
§ OISK 8 OSK . i 
§@ F-TRACK TAPE | fi HT? t 
t og-tRACK TAPE) tO 
@ CASSETTE ‘ CAS i 
f BIKARY CARD FILE ¢ BIN f 
& PRINTER OUTPUT i : LST i 
t MULTI-PACK DISK t))OKPF st 


22 GP GA OD GEE) 0 EH GR OD SE EE A Gt ED EE EE EE ES ED ES GS SD OD GE OR SS ER ES OP a OO Os a es 


Tabie 422 Media Abbreviation Table 


To go frosa card to gagnetic tape the shorthand 
<routine=type> would be “CROMTP™. The tonghand 
woudd be "CARD TO TAPE* with "TC" being optionai. 


If <routine-tyre> is omitted» default is disk-to-disk.| 


If BIN or BINARY is used» the last card in the file 
Should have "ENC~“CF<“DECK® starting in colugsn ane. 


fors 
fors 
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The format of the <itinput-file-id> is the same as used in MCP 
control instructions. Uniabeled tape files for which the user 
desires toa use defauit vaiues aust have an <input-fite-id> of 
"NONE" Cinecluding the quotation rarks). 


The <inputerec-ieng> in bytes (maximum Length: 4000 bytes for 
ASCII conversion and TAG files and:‘8sC00 tytes for aii other 
copies) must be the first numeric entry following the 
<input-file-id>. [f omitted» a wecord tength of 80 and a 
blocking factor of one is assumed for al’ files except disk and 
fabeled tape fites which wiit use the record Length of the file 
wuhen created. The <ingut“hiocking=factor> must be the second 
Numeric entry following the <input-fiile-id>. If omitted and a 
<receheng> entry itis presents then an unbiocked file is assumed. 


The VARIABLE or VARY entry may be used after the: <input-file-id> 
entry to indicate that the input file will have variable-length 
recordss but not variabier-tength cutput. 


The TAGS <tag-filerid> entry may be used to specify the use of a 
tag file for indexirg intc the input file. The tag file must te 
created with the .cC&CL or RPG naming conventions and never 
modified. (See the COBOL ofr RPG reference manuai-) The user 
should be gware that the cutput file with be a sequential file 
ordered by the TAG file keys and wild not match the TAG fite or 
the input file. , 


The <input*-fileraccess*mcode> entry pay be one of the following 
Cincluding quotation marks): 


1. ASCII files: “"ASCII® 

2e 8CL files: “E8CL™ 

3e2 BINARY fthles: "AINARY" . . 

&e EBCOIC files? “EBCDIC"@ CIf this entry is omitted» EBCDIC 
is assumed as the defauit) 


If the input fife is a labeled tape» the access mode will be that 
with which the file was created. 
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To change the parity of tape files from oda ta evenr use the 
HCP°s FELE® or DYNAMIC or MODIFY statement. 


Exsnpies 


FILE INP.FILE EVEN 
or: PDYNANIC <job-numgber> FILE INPeFILE EVEN 


The format of the <output-file~id> is the same as that of the 
<input°filerid>. If an untabeied tape fite is desiredr the 
<outputefile-id> must be “KONE™ Cincluding the quotation marks). 
Default vatues for the four numeric <autput-file-id> entries are 
the folioning: 


<outputrerectang> 80 
<blocking*factor> i 
<biocks-per-area> “100 


<nusber-of-areas> . 25 


For disk or iabeled tape» default <output~record-Length> Cabbres 
<output-reccwlieng>>} and <blocking-factor> is the same as those of 
the input files for diske defauit <biccks“per-area> and 
<number<-of-areas> wild be those cf the input file. 


if the user wishes to override the default 
<output*record-Length>s he must enter the desired 
<outputcrecord-iength>. The same is true for <btocking=factor>» 


<biocks~-per-area>» ana <nusber-cof-areas>.o 


Entcies must follow in sequence. Succeeding entries presume ail 
the necessary previous oneése For examples ai <blocks-per-area> 
entry cannot be wade without both <cutputtrecord-length> and 
<blocking~factor> entriese One cane howevers stop at any point 
in the sequence and the appropriate default vahues wiil be 
assumeda — 


The <output-file-access~sode> entry may be one of the foilowing 
Cincluding quotation marks): . 


le ASCII fides: *a5Scri* 
2. BCL fides: "8CL@ 

3e BINARY fides: "“BINARY* 
4e EBCDIC fiiess *“EBCOIC* 
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If this entry is osittede EBCDEIC is assumed. 


To change the parity from odd to evene use the MCP*s FILE>» 
DYKRAMICe of MODIFY statement. : 


Exanmpies 


“9FILE OUTP.FILE EVEN 
ors PDOYNANIC <jcb nuaber> FILE QUIP.FILE EVEN 


The VARIABLE or VARY entryr itn this position Ci.é@es after the 
<output*fitecrid>) >» indtcates that both irput and output records 
are vartahte-length. 


The SKIP <integer> entry may be used to SKIP a specified nauaber 
of records prior to creating the output file. 


The INCLUDE Cor INXCL) <integer> entry may be used to specify how 
many fecords shoulc be reag from the input file. If the integer 
value equals zerocr an eanpty file witli be created. 


Selective copying af records can be acccsplished by the following 
options: 


OPTION EFFECT 

SEARCH Starts crinting at the first occurrence 
SELECT Prints oniy records that are equat 
EXCLUDE Prints only records that are not equat 
KEY Keyroperator condition 


NOTES Only one option per specification alloned. 
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These options are further described by the fottoning parameters: 


<start-*posn> 


<key~leng> 


<key~op> 


<search-arg> 


<start-positicn> denotes the starting position 
ef the fietd in the record where the first 
positicn in the record is retative position 
one. This numeric entry wild specify the byte 
Cfor aipha or hex)ds the digit Cfor 4-bit)ds» or 
the bit in which the fieid begins. 


<key-Length> is used only with KEY option ta 
specify the Length af the field to be tested. 
The waximum length #s 20 Cbhits» digitss or 
bytes). If this option is omitteds then the 
cefauit will be equal toa the tength of the 
<searchrargument> up to 20 (bitse digits» or 
bytes). ; 


<key~operator> is used onty with KEY option to 
denote the type of comparison to be perforned 
by the KEY ‘option ard say be one of the 
Fotiowting: 


Cperator Meaning 


GTR ce > Greater 
GEQ or >»= Greater than or equal 
EQL cr = Equai 
LEQ ce <= less than or equat 
“ss cr < Less than 
NEQ - Not equai 


<search-argument> presents the data against 
which the specified field in the record wiit 
be compared. The type of field ts indicated 
by the first character(s) of the 
<search-argument>: | 
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FIELO TYPE POSITION © 
SPECIFIER TYPE DATA TYPE 
" or btank byte alphanumeric 
a byte hexadecimal 
a4) digit hexadecimal 
a¢éi} bit binary 


The ending field-type specifier should be the 
same as the beginning specifiers» except for 
cigit ard bit where “a” is sufficient. 


<nun-to-return> <nunber*to-return> is an integer used to stop 
the selective process after the number of 
records that the cption specified thas been 
reached. The SEARCH option does not have this 
capability. Care shauld be taken when using 
both the INCLUDE and <numberctorreturn> 
options togethers as the list wili terminate 
when either of the two options is satisfied. 


LISRARY TAPE DIRECTORIES 


Litrary tape directecries can be listed or punched with the 
following parameters: | 


08 Gh GR 02 & om ES 08 OD BD EE A ©) Oh OD OD ©) 8 AS Oe ES OD OE ee GD C8 OD WE OF D Gb GR AB Se ES OR 25 C5 et EE CO 8 OS 9D ON OS ee Oe a 8 om GE GE OP 8 GP 2D 3 88 Om 


i { 
|  <€fob-nurber>AX PD CPUNCH] <filte~identifier> . an | 
= | t 


12 SO GD a) Th A Bh OP ED OD OD Se Eh UR OD GP OE GE) GR AE OD OD CE ED AD OE OO EE SE ER ED CE GR OE OR GR ED GE OS Ee OD GS ES OD OE OD OF See) eee ee 


If a tibrary-tape directory is to be punched then the entry 
immediately following the POD entry must be PUNCH. If this entry 
is omitted then a Listing is assumed. The <filecridentifier> 
entry is the library-tape rare. 


a | 


BURROUGHS CCRPORATICN | ‘COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GhOUP 81800/81700 DMPALL 
SANTA BARBARA PLANT a PeSe 2212 SLL6 CREV. E) 


The 


ERROR MESSAGES 


following error gwessages are printed on the console printer 


CSPO) if erroneous specifications are entered. Variables and 
comments are indicated below in toner-case. 


- 


le 
Ze 


Lie 


12. 


<Input-fiteridentifier> NOT ON BISK 
MF.ED OR PACK.ID NUMERIC 


CTthe first name found is nuseric and is not surrounded 
by quotaticn sarks.) 


INVALIO HARCWARE TYPE OR QUTPUT FORMAT 

NUMERIC VALUE MUST FOLLOW <SKIP» INCLUDE» or SEARCH> 
<Usersvinput> ITEM SHOULD NOY APPEAR BEFORE LIST OR PERFORM 
<Usersvtinput> AREAS EXCEEDS 105 NAXIMUN 

SEARCH FIYELE OQUISIOE RECORD 


= 
CSEARCH starting pcsition plus tength is greater than 
the input record length.) 


INVALID SECOGKD HOWM“KAME <input item> 


The first hardware nage xvas founds but the second 
hardware name was invatid.?) 


HESSING SECCND HOWNAME 

NQ SPECS 
C@lank found as input specification) 

<Users~input> IS NGT VALID AFTER SECOND FILE“NAME 
Cistudace type cauld have been invalid or treated as an 


input°file-id or an invalid entry was found after the 
second file-nane. ) 


<€Inputrfiteridentifier> 15 A SYSTEM LOG AND CANNOT BE COPIED 


OR LISTED. 
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13. INVALID RECCRO LENGTH <record-length> 
CThe record Length for the input or output file has 
exceeded 8000 bytess or 4#000 bytes with TAG: option 
or ASCII conversicns or is equat to zero.) 

14. NO RECOROS PROCESSEQ--ENO OF FILE REACHED 
CInput fille is expty or has been skipped to END.) 

152 EQUAL SIGN IS NOT A VALIO FILE-ID 

16-2 <Search Argunent> IS NOT A VALID KEY ARGUMENT 
CThe <search-argument> has hexs digit or bit data type 
specifiec and the data contains invalid characters for 
that type or the <search-argument> is not terminated 
with an *a%) 

17. PARITY ERROR ~- REC.NUNS <record-numaber> 

18. <Tag-file-race> I/C ERROR <record-number> 

19. INVALID KEY LENGTH <key-Length> 
€Key-tength given is less than 1 or greater than 20.) 

20. INVALID KEY CPERATOR <key-operator> 
(<key~operator> is not a valid entry. See vatid list.) 


2i. INVALIO TAG FILE <tag-file-nane> 


CTag-file-name was not created with COBOL or RPG naming 
conventions ) 


22. INVALID INDEX FILE <input~fide-naze> 
(The index file tis not a disk fite.) 
23e WARKING = <outputcfite-nasme> IS NOT AN TAD FILE 


CThe input file being copied is an Instaltation 
Aflltlocateac Disk CIAD) fide» but the output file is not. 
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EXAMPLES 


The input for ata the follcuing examples is a disk file» tabeted 
DSKL and containing the follauning records: 


RECORD COLUMN 1 COLUMN 2-3 
02 
02 
03 
04 
05° 
06 
07 
08 
09 
10 
it 
12 
13 
14 
15 


ran 
Ove a Wn & Ww hd - 


~enOrararawnr>e> © 6 > > 


EXAHPLE 1 


COPY OSK2 CESKE SKIP 5S INCL 5 SELECT 2 A 


The first 5 records of the disk fife DSKL wiit be skipped and 
only the next 5S wit be scanned. Fike OLSK1 widk contain: 


Cutput Fecord # Isage Input Record ¢ 


1 | A06 6 
e + AO? v 
3 AOD 9 


In the SELECT stategents» note that the field could aiso have been 
specified as “"A® or 2012 or 3€439C123 or QLicdcdcias» depending on 
the type of search argument the user desirese These variations 
are aiso true for the remaining examples 2 - 6. 
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EXAHPLE 2 


COPY OSKL DISK2 SKIP 5S INCL 5 EXCLUDE 1 B 4 


The first 5 records of the cisk file DSKi will be skipped. A 
Raximus of 5 records wifit be scanned and a maximum of 4 records 
wild be copied. Fite DOISK2 wilt contain: 


Cutput Record # Image Input Record # 
i AQ6 6 
2 - AQ? 4 
3 AQ? 9 


Notes The INCLUDE cption was exhausted first in this case. 


EXAMPLE 3 


COPY DSKL DEISK3 SKIP 5 INCL 5 KEY 2 £ = A 


The first 5 records of the disk file OSK1 wild be skipped» and 
onty the next 5 wiht be scanned. Fife DISK3 wiht contatn: 


Cutnut Record # Image Input Record # 
1 A06 6 
2 AQT a 4 
3 Ag9 | 9 


EXAMPLE 4 


oe oh a & 80 HY OH 


LIST OSKL SKIP S INCL 5 SELECT 2 A 


The first 5 records of the disk file DSKI will be skipped» and 
onty the next 5 wiil be scanned. The Listing will contain: 
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Output Record # Irnage Input Record # 

1 AQ6 6 

2 A07 7 

3 AQ9 9 
Example 5 


7 SP Ub a Gh aD ah a Dp 


LiSt O5K1 SKIP 5 INCL 5 EXCLUDE 1 B 4 


The first S records of the disk file DSKL swiff be skipped. 


A 


Maximum of S records will be scanned and a maximum of 4 records 


wit be copied. The Listing wilt contain: 


Cutput fecord ¢ Image Input Record & 


6 AQ6 6 
7 Ag? 7 
9 . “AQS 9 


Notes The INCLUDE option was exhausted first in this case. 


‘Example 6 


7 Gh ON 1 ae oe ee a 


List OSKE SKIP 5 INCL 5 KEY 1 2 = A 


The first 5 recoras of the disk fite OSKL wilt be skipped» 
only the next. 5 will be scanned. The “isting nilt contain: 


Cutput Record # Image Input Record & 


6 A06 6 
7 Ao7T 7 


9 AO? 9 


and 
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